//=================================\\
           v3 Arcade 1.0.8
         for vBulletin 3.7.X
\\=================================//

Thanks for downloading v3 Arcade, version 1.0.8 for vBulletin 3.7.x

"v3 Arcade" is the third Arcade system I've written for vBulletin. It's coded from scratch, not a port of an older version - and because it was coded specifically for vBulletin 3.5 it uses the product system for code modifications, and utilizes AJAX technology throughout. Here's a brief rundown of the features in this version of v3 Arcade. 

- Supports both v3 Arcade and iB games.
- Download *legal* free, premium and multiplayer games directly from v3arcade.com to your Arcade installation.
- Import script to convert your old v3 Arcade installation. (A script to import games, scores and news from old IBPro installations is available here, thanks to Tigga: http://www.v3arcade.com/forums/showthread.php?t=324)
- AJAX based instant ratings, for simple to use game ratings.
- AJAX based inline score moderation.
- AJAX based instant game searching.
- Tabbed, customizable categories.
- Challenge system for one-on-one contests.
- User-permission based settings for email/PM notification, challenge settings.
- Streamlined viewing modes for users with lower resolutions.
- AJAX based quick stats, for viewing statistics by passing the cursor over a username.
- Mass import tools for importing games in bulk.
- Reverse and decimal based scoring.
- Arcade-only closure with customizable message.
- Per game criteria, allows you to control access to games by reputation, posts, registration length.
- Postbit based awards.
- Personalized recommendations for other games users might like, based on what theyre playing.
- Quick stats, letting a user know how many other scores are above and below theirs.
- Score ranking.
- Admin customizable score feedback, displays a message based on how well as user has done.
- Numerous Admin CP settings to control things like popup opacity, maximum comment length, hover delay length, and numerous other behaviors. 
- Full admin control over the types of content allowed in comments (BB code, HTML, smilies, etc.)
- Usergroup based access permissions.
- Fully phrased, for each translation into other languages.
- An ever growing collection of third party add-ons, thanks to Oblivion Knight.
- A slick, professional layout.

//=================================\\
              Change Log
\\=================================//

1.0.0 - First public release.
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

1.0.1 - Bug fixes and feature release.
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
- More visible postbit award presence.
- Reverse scoring option added to games.
- Data dictionary implementation, makes sure the Arcade database changes are correctly made.
- Template grouping.
- "Posts in the last 24 hours" criteria added to games.
- Other bug fixes.

1.0.2 - Bug fixes.
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
- Hopefully this will be the last big bug fix release. The problem is table prefixes. Because of one bug early on, it caused a whole load of different issues when using the product system for upgrading. A whole new set of problems arose in 1.0.1.

1.0.5 - New features and bug fixes.
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
- Added search on/off toggle function in Admin CP.
- Opera compatibility fixed.
- Welcome message now an Admin CP option.
- Use "Miniature Mode" By Default option added to the Admin CP.
- New AJAX based favorites system.
- Hooks in place for vbBux integration (coming soon from CMX_CMGSCCC)
- Per-category on/off settings.
- Default user settings for challenges and notifications.

- Database error when pruning a users scores with table prefix. 
http://www.v3arcade.com/forums/vbugs.php?do=view&vbug_id=88

- Database error when viewing distinct high scores when the table is empty.
http://www.v3arcade.com/forums/vbugs.php?do=view&vbug_id=62

- Notification bug fixes, users should now be notified based on their Arcade settings.
http://www.v3arcade.com/forums/vbugs.php?do=view&vbug_id=56

- Timestamp bug fixed for news and events.
http://www.v3arcade.com/forums/vbugs.php?do=view&vbug_id=67

1.0.6 - Bug fixes.
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
- Fixed a bug where unregistered users could challenge people in the Arcade.
- "Wipe All Scores" tool added.
- "arcade_award_bit" template is now cached correctly.

1.0.7 - Features and Bug fixes.
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
- Guests can now play games, but their scores aren't recorded. If a guest plays a game, they're asked to register if they want their score recorded afterwards.
- Admins can now wipe all scores through the Admin CP.
- Admins now have a tool to enable challenges by default for all users.
- Usergroup requirements for games are now in place.
- Admins can now choose to flip the columns and have the smaller panel on the left, with the larger content area on the right.
- News & Events - now entries contain links to games.
- Numerous bug fixes.
- Mass category changer for altering game categories en masse.
- High score rebuilder in the Admin CP.
- 50 new titles added to the v3arcade.com game store


//=================================\\
            Branding Free
\\=================================//

All v3 Arcade installations carry and require a small "v3 Arcade" logo in the footer, as well as the text "Powered by v3 Arcade" which links to http://www.v3arcade.com. A "branding-free" license is available at the cost of $60 USD per installation, available from www.v3arcade.com. 

A branding-free license entitles you to:
- Remove the "v3 Arcade" logo and "Powered by v3 Arcade" link from the footer of all Arcade pages.
- Premium support on v3Arcade.com.
- A input on what new features you want to see added to the next release, via the "Development Discussion" forum.
- Access to v3 Arcade beta releases.
- Access to other beta events. (E.g. live multiplayer games, new vBulletin related products, etc.)


//=================================\\
          www.v3arcade.com
\\=================================//

If you're looking for more games, add-ons, support, tutorials, or anything Arcade related - www.v3arcade.com is the place to go. :)

//=================================\\
   Upgrading from vBulletin 3.0.x
\\=================================//

If you're upgrading from a version of v3 Arcade for vBulletin 3.0.x, follow these instructions.

1. Make sure you upgrade vBulletin to 3.5.1 first. 
2. Remove all of the old Arcade templates from the forum. To do this, upload arcadetools.php from this zip file to your Admin CP directory and visit http://www.yoursitehere.com/forums/admincp/arcadetools.php?do=clean
3. Read "Installation Instructions.txt" from this zip file, and proceed with installation as normal.
4. Run http://www.yoursitehere.com/forums/admincp/arcadeimport.php to import old games and scores.

*^*^*^*^*^*^*^*^*^*^*^*^*^*^*^*^*^*^
**IMPORTANT** - NEVER run arcadeimport.php, unless you're upgrading from a version of the Arcade which ran on vBulletin 3.0.x. Doing so will wipe all previous Arcade data!
*^*^*^*^*^*^*^*^*^*^*^*^*^*^*^*^*^*^


//==========================================\\
   Upgrading from vBulletin 3.5.x and above
\\==========================================//

//==========================================\\
     Upgrading from v3 Arcade 0.8.9-1.0.0
\\==========================================//

If you're upgrading from version 0.8.9-1.0.0, follow these instructions.

1. Upload all files in this zip from the "files" directory to your forums directory, overwriting them where necessary.
2. Import product-v3arcade.xml as a product. (Via "Plugin System" > "Manage Products" > "Add/Import Product" in your Admin CP.) Select "Yes" for the "Allow Overwrite" option.
3. Perform the following template edits.


In the template: postbit OR postbit_legacy (depending on which one you use)
=============================
FIND:
=============================
<a class="bigusername" href="member.php?$session[sessionurl]u=$post[userid]">$post[musername]</a> 
=============================
REPLACE WITH:
=============================
<a class="bigusername" href="member.php?$session[sessionurl]u=$post[userid]">$post[musername]</a><!-- v3 Arcade --> <if condition="$post['arcadeawards']"><a class="bigusername" href="member.php?$session[sessionurl]u=$post[userid]"><img src="$vboptions[arcadeimages]/trophy.gif" align="absmiddle" alt="$vbphrase[arcade_champion]" border="0" /></a></if>
<!-- /v3 Arcade -->
=============================


//==========================================\\
     Upgrading from v3 Arcade 1.0.1-1.0.6
\\==========================================//

1. Upload *all* files in this zip from the "files" directory to your forums directory, overwriting them where necessary.
2. Import product-v3arcade.xml as a product. (Via "Plugin System" > "Manage Products" > "Add/Import Product" in your Admin CP.) Select "Yes" for the "Allow Overwrite" option.

You're done!
